home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1 Issue 2 / PDCD-1 - Issue 02.iso / _editors / editors / _zap / !Zap / 3rdParty / Wagenaar / DWExtHelp next >
Text File  |  1994-10-20  |  3KB  |  84 lines
  1. ZapDWExt - an extension to Zap
  2. ------------------------------
  3.  
  4. [I've inserted the setup details here - Dominic]
  5.  
  6. If you wish to use ZapDWExt, you should include the following
  7. into Zap's !Run file:
  8.  
  9.   | Set search path for OPENMEMBER command
  10.   Set ZapCurDir$Path @.
  11.   Set ZapDWS$Path ZapCurDir:,ZapCurDir:^.,C:
  12.  
  13.   | Set standard options for cc
  14.   Set Zap$CCOptions -IC: -throwback -Lc:o.stubs,c:o.risc_oslib -Desktop ^
  15.  
  16.   | _I_ don't have standard options for amu, so next line is commented out,
  17.   | but _you_ may have standard options.
  18.   |Set Zap$AmuOptions whatever_you_want_
  19.  
  20.   | ZapDWExt doesn't work with RISC OS 2. Sorry. If you really want it working,
  21.   | I might try to replace the offending code... e-mail: wagenaar@phys.uva.nl
  22.   If Zap$OSVsn>=300 Then RMLoad <Zap$3rdParty>.ZapDWExt
  23.  
  24. ZapDWExt does not provide any new modes, although I plan to add a
  25. 'soft wordwrap' mode, featuring soft line ends. This will facilitate
  26. porting texts to Impression and WPs. (WP==wordprocessor,
  27. WP!=WordPerfect).
  28.  
  29. It supports the following commands:
  30.  
  31. BLOCKID        Blocks the identifier under the cursor. An
  32.         identifier is as defined by ANSI C, ie it starts with
  33.         a letter, and may contain numbers, letters, and the
  34.         underscore.
  35.  
  36. FIRSTBLOCK    Finds the first occurence in the file of the marked
  37.         block.
  38.  
  39. FINDID        := BLOCKID:FIRSTBLOCK - ie, it finds the first
  40.         occurence in the file of the identifier under the
  41.         cursor. This may be viewed as a very primitive
  42.         function finder, but it is very powerful in the sense
  43.         that it can also find the definition of a variable or
  44.         a macro. :-)
  45.  
  46. STARCOM        Does '*TaskWindow "<arg>" -quit'. <arg> may be
  47.         included in the Keys file, or typed in a mini-buffer.
  48.  
  49. CC        Compiles a C program using 'STARCOM "cc <filename>"'.
  50.         It opens a minibuffer in which the command line
  51.         options may be specified. Currently, the standard
  52.         options are: '-IC: -throwback -LC:o.dwlib,c:o.stubs,
  53.         c:o.smallrol -Desktop ^'. This is probably only useful
  54.         for me, so in future versions this will be changed.
  55.  
  56. OPENMAKE    Opens the makefile for this project, if the string
  57.         'Makefile: <name>' is included in the start of the
  58.         file.
  59.  
  60. OPENREF        Opens a file referenced at the cursor, eg for
  61.         #include <fff.h>
  62.  
  63. OPENCH        If the current file is named '...h.yyy', opens
  64.         '...c.yyy' and vice versa
  65.     
  66. OPENOTHER    Does either OPENREF, OPENMAKE or OPENCH, whichever is
  67.         most appropriate.
  68.  
  69. MAKE        Does 'STARCOM "prefix <dirname> |M amu -f
  70.         <leafname>"'.
  71.  
  72. ANYCOMPILE    Does 'MAKE' or 'CC', whichever is appropriate.
  73.  
  74. CLOSETBTW    Closes all throwback and task windows.
  75.  
  76. MODBRK        Sets a breakpoint in a module, at the cursor address.
  77.         The module must be loaded into Zap using 'Create.Get
  78.         module.<modname>', and the filename must have remained
  79.         unchanged. You must be careful when using this
  80.         command, because the computer may crash if you set a
  81.         breakpoint in a piece of code that is used in IRQ
  82.         mode. So: don't set breakpoints in the UtilityModule
  83.         unless you know what your doing.
  84.